home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / getgroups.man < prev    next >
Encoding:
Text File  |  1989-11-03  |  1.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. GETGROUPS             C Library Procedures              GETGROUPS
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      getgroups - get group access list
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ##iinncclluuddee <<ssyyss//ppaarraamm..hh>>
  13.  
  14.      nnggrroouuppss == ggeettggrroouuppss((ggiiddsseettlleenn,, ggiiddsseett))
  15.      iinntt nnggrroouuppss,, ggiiddsseettlleenn,, **ggiiddsseett;;
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      _G_e_t_g_r_o_u_p_s gets the current group access list of the user
  19.      process and stores it in the array _g_i_d_s_e_t.  The parameter
  20.      _g_i_d_s_e_t_l_e_n indicates the number of entries that may be placed
  21.      in _g_i_d_s_e_t.  _G_e_t_g_r_o_u_p_s returns the actual number of groups
  22.      returned in _g_i_d_s_e_t.  No more than NGROUPS, as defined in
  23.      <_s_y_s/_p_a_r_a_m._h>, will ever be returned.
  24.  
  25. RREETTUURRNN VVAALLUUEE
  26.      A successful call returns the number of groups in the group
  27.      set.  A value of -1 indicates that an error occurred, and
  28.      the error code is stored in the global variable _e_r_r_n_o.
  29.  
  30. EERRRROORRSS
  31.      The possible errors for _g_e_t_g_r_o_u_p are:
  32.  
  33.      [EINVAL]       The argument _g_i_d_s_e_t_l_e_n is smaller than the
  34.                     number of groups in the group set.
  35.  
  36.      [EFAULT]       The argument _g_i_d_s_e_t specifies an invalid
  37.                     address.
  38.  
  39. SSEEEE AALLSSOO
  40.      setgroups(2), initgroups(3)
  41.  
  42. BBUUGGSS
  43.      The _g_i_d_s_e_t array should be of type ggiidd__tt, but remains
  44.      integer for compatibility with earlier systems.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0              April 10, 1987                         1
  64.  
  65.  
  66.  
  67.